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Preface 



As a person who is passionate in academic transmission of knowledge I found it 
really important to have a repository where scholarly publications could be archived 
and easily retrieved. My Institution / University does not have any such archiving 
facilities. I sought the advice of my teacher (who else other than google) which gave 
me some options of softwares which could be installed in a website. After a thorough 
research I found Eprint software fitted the billing to the core. On top of it it came 
free as it was open source. As with all open source software this software too lacked 
documentation. None of the manuals I saw in the internet was complete. Even the 
ones I had access to assumed that I had a basic fundamental knowledge of server 
managment. I had to struggle for nearly 3 months before I hit "Eureka ". 

Now I have embarked on creating an installation manual for the software which does 
not assume that the reader has basic knowledge of server management. The codes 
and illustrations in this book were taken from my own installation. I could have 
fallen here and there while taking my baby steps towards completing this project. I 
hope readers would appreciate this and forgive me for any errors if any in this 
manuscript. 



Please mail in your comments and suggestions to: drtbalu(d),gmail. com 



■v.w— IWI 



Eprints from below upwards by drtbalu is licensed under aCreative Commons 
Attribution-NonCommercial-NoDerivs 3.0 Unported License. 
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Introduction 



In this digital era it is imperative to safegaurd and showcase our documents / creations. Gradually 
world is moving towards the inevitable paperless domain. This is where reliable archiving facilities 
become rather important. Towards this ultimate end a large number of software have been created. 

Ideal archiving software should: 

1 . Archive the submitted material with ease 

2. Should have a robust database for storing data 

3. Should expose the digital content to search engines 

4. Should be easy to install and maintain 

5. Should be secure 

6. It should be compliant with open archives initiative protocol for metadata harvesting 

7. Last but not the least it should be cost effective 



One software that fulfills all the above said criteria withe ease is Eprints '. This is indeed a free and 
open source software which can be used to build open access repositories. Eprints has many 
features commonly seen in popular document management systems. This software is ideal for 
creating Institutional repositories 2 and scientific journals. 

This software was created by University of Southampton school of Electronics and Computer 
science in 2000. This was indeed a logical fall out of Santa Fe Meeting 3 which launched the open 
archives Initiative protocol (OAI). 

Eprints software is actually a web based command line application based on LAMP 4 architecture. 
The configuration files of EPRINTS are written in Perl / XML and hence can successfully run under 
multiple operating systems like Linux, Windows, Mac, and Solaris. It is hence easy to edit the 
configuration files according to one's requirement. 

Major problem which the author noticed with Eprints is that its literature is not adequate for a 
novice to install and maintain a repository. For any software to become popular it should be easy to 
install and operate. Eprints actually an enigma, because of inadequate literature and forum support. 
This has prompted the author to write this manuscript with an intention of taking this unique 
software to the doorsteps of even novice users. 

Is it really difficult to install and maintain an Eprint repository? 

The answer to this question is a frank no. It is only the paucity of literature that makes the task 
daunting. In this manuscript the reader will be taken in a step by step fashion through the 
installation protocol of Eprints in Ubuntu 12 server. Ubuntu 12 has been choosen not as personal 
preference but because of the convenience it provides since preconfigured Eprint installation scripts 
are available for ubuntu which takes care of dependency problems. For a novice dependency 
problems could be hair raising. 



The aim of the book is not creating a technical manual of Eprints, but to make installation and 
maintenance of Eprint site a bit easier for novice. 

Suggested tools to be used in Eprint installation: 

1 . A virtual Private server 5 with full root access. This is the most important requisite for eprint 
installation. After complete installation eprint server takes over the entire server. (You cannot 
install eprints in shared hosting). Technically speaking it is possible to install eprints inside a folder 
of a server leaving the server free for other installations. It is an arduous task which needs lot of 
specialization and is left for those Geeks out there. 

2. Linux installation - Since this manuscript has been created with Ubuntu 12 experience, it would 
be prudent if the virtual private server (now on it will be termed as vps) is loaded with this 
operating system. 

3. A working LAMP installation in the VPS (Virtual private server). 

4. Installation of Webmin 6 which is a open source version of Cpanel. This really makes server 
configuration easy for a novice because of its GUI . 

5. Working Internet connection (This is important). 

6. SSH client ( Putty ) SSH is an acronym for secure shell 7 . This is used for accessing the virtual 
server operating system remotely from a desktop. This is usually performed using command line. 
PUTTY can be downloaded and installed in windows / Linux machines. It is a free software. 

A small word on installing PUTTY to your desktop: 

If your desktop operating system is windows then windows version of PUTTY can be downloaded 
and installed by double clicking the installer. If the desktop contains Ubuntu 12 operating system 
then PUTTY can be installed by using the command given below: 

Installing PUTTY in Ubuntu 12 desktop: 

Press ctrl-ALT-T 

This will invoke the terminal. 



sudo apt-get install putty 



Terminal 

File Edit View Search Terminal Help 



sudo apt-get install putty 



[sudo] password for ihaveapc: 

Reading package lists... Done 

Building dependency tree 

Reading state information... Done 

The following extra packages will be installed: 

putty-tools 
Suggested packages: 

putty-doc 
The following NEW packages wilJl^be installed: 

putty putty-tools 
upgraded, 2 newly installed, to remove and 6 not upgraded. 
Need to get 1,023 kB of archives. 

After this operation, 2,258 kB of additional disk space will be used, 
Do you want to continue [Y/nJ? y| 



- + x 



Virtual Private Server 



Virtual private servers can be secured from Hosting Providers like: 

Godaddy 

Siteground 

Hosting providers usually provide VPS access on monthly / yearly tariff. 

Amazon E2 Instance: 

This is another way of securing a VPS. 

A quick foray to their websites will provide relevant information. 

Before booking a VPS one has to choose a domain name to go with it. Domain name can be 
booked with any of the Hosting providers with whom VPS is going to be hosted. While booking a 
VPS one need to give the domain name also. 

Ideal VPS configuration: 

Ubuntu Linux 12 

CPU 1.68 GHZ 

Disk space 50-60 GB 

IP address - minimum of one 

Configuring VPS: 

Before configuring the VPS one should choose ubuntu 12 as the operating system. It has to be 
specified while making the purchase. 

After the VPS is set up the following details will be sent. 

1 . Url for VPS control panel 

2. IP number assigned to the VPS 

3. Root password for the virtual machine 



Using SSH client PUTTY to configure VPS 



SSH client is the easy and secure way to log into your VPS. 
PUTTY is started: 



PuTTY Configuration 



9QDC9 



Category: 
¥ Session 

Logging 
T Terminal 

Keyboard 

Bell 

Features 
w Window 

Appearance 

Behaviour 

Translation 

Selection 

Colours 

Fonts 
T Connection 

Data 

Proxy 

Telnet 

Rlogin 
► SSH 



About 



Basic options For your PuTTY session 
Specify the destinationyou want to connect to 
Host Name (or IP address) Port 



ip goesherel 



22 



Connection type: 

O Raw O Telnet O Rlogin % 

Load, save or delete a stored session 
Saved Sessions 



SSH O Serial 



Default Settings 



Load 



Save 



Delete 



Close window on exit: 
Always O Never 



O Only on clean exit 



en 



Cancel 



In the hostname column the IP alloted to the VPS is entered. 



Enter 22 under Port. 



Click Open. 




In the log in screen of PUTTY enter root after login as: 
Press ENTER key. 




In the next screen the root password will have to be entered. 
Press ENTER again 



It will take you into the operating system. 

Caution: 

It should be noted that by default wot user is disabled in Ubuntu. If your service provider has 
enabled it root log in can be performed. 

If root user has been disabled in the VPS then the steps given below will have to be followed 
inorder to enable it. Because root user has to be enabled before Eprint installation could progress. 



Using SSH client PUTTY log into the VPS with the user name / pw supplied by the service 
provider. Key in the commands given inthe command prompt window. 



$ sudo passwd root 

[sudo] password "user name": 

Enter new UNIX password: 

Retype new UNIX password: 

passwd: password updated successfully 



The above command would effectively enable root user with associated password preferred by you. 



Get cloud support with Ubuntu Advantage Cloud Guest; 
http ; //www , ubuntu , com/business/services/cloud 

Use Juju to deploy your cloud instances and workloads: 
https ; //j uj u , ubuntu , com/#c 1 oud-prec i se 

packages can be updated, 
updates are security updates. 



The programs included with the Ubuntu system are free software; 
the exact distribution terms for each program are described in the 
individual files in /usr/share/doc/*/copyright, 

Ubuntu comes with ABSOLUTELY NO WARRANTY, to the extent permitted by 
applicable law. 

To run a command as administrator (user "root"), use "sudo <command>" 
See "man sudo_root" for details, 

ubuntuQipi 



Screen shot 1 showing sudo passwd root command 



Get cloud support with Ubuntu Advantage Cloud Guest; 
http; //www, ubuntu, com/business/services/cloud 

Use Juju to deploy your cloud instances and workloads; 
h ttps ; // j u j u , ubuntu ♦ com/#c 1 oud-pr ec i se 



packages can be updated, 
updates are security updates. 



The programs included with the Ubuntu system are free software; 
the exact distribution terms for each program are described in the 
individual files in /usr/share/doc/Vcopyright, 

Ubuntu comes with ABSOLUTELY NO WARRANTY, to the extent permitted by 
applicable law. 



To run a command as administrator (user 
See "man sudo_root" for details, 

ubuntuQip- 

Enter new UNIX password; 

Retype new UNIX pafiswnrrlt 



use "sudo -(command) 



Screen shot 2 showing password change for root log in effected. Password needs to 

be typed twice in this screen before pressing enter key. Caution: Typed password will 

not be revealed on the screen. The screen will look empty as you key in the pass 

word. 



http;//www, ubuntu, com/business/services/cloud 

Use Juju to deploy your cloud instances and workloads; 
https;// juju, ubuntu, com/#cloud-precise 



packages can be updated, 
updates are security updates. 



rhe programs included with the Ubuntu system are free so ,r " 

the exact distribution terms for each program are described in the 

individual files in /usr/share/doc/*/copyright, 

Jbuntu comes with ABSOLUTELY NO WARRANTY, to the extent r~" 
applicable law. 



l"o run a command as administrator (user "roof 
lee "man sudo_root" for details, 

ibuntu@ip- 

inter new UNIX password; 

ietype new UNIX password; 

>asswd; p^ssiiinrrl UDrlflt.prl sunnpss 

ibuntuQi 



jse "sudo <command) 



Screen shot 3 showing confirmation of pass word update 



Installation of Apache Web Server 



Apache is a free open source server software. It needs to be installed. Before 
proceeding with Apache installation the Ubuntu operating system needs to be 
updated. 



Using the terminal window of SSH client Putty key in the following command: 



sudo apt-get update 
sudo apt-get install apache2 




Screen shot showing sudo apt-get update 



lit http://us-east-l.eCi 

lit http;//security,ubur 

lit http;//us-east-l,ec! 

Set: 13 http://us-east-l. 

ss [634 kB] 

iit http;//us-east-l,ec! 

ies 

lit http;//us-east-l,ec! 

Set: 14 http;//us-east-l. 

;ages [209 kB] 

Set; 15 http;//us-east-l. 

idex [3,564 B] 

Set: 16 http://us-east-l. 

.onlndex [2,850 E] 

Set: 17 http;//us-east-l. 

£1 

lit http://us-east-l.ee! 

Set; 18 http;//us-east-l. 

;n [290 kB] 

lit http://us-east-l.ee! 



!, archive, ut 
itu.com precise-sec 
!, archive, ubuntu, co 
ec2 , arch i ve , ubuntu 



irity/uni verse Translation-en 

i precise-updates/universe Sources 

com precise-updates/main amd64 Packai 



2. archive. ubuntu.com precise-updates/universe amd64 Pack 



,archive, ubuntu, con 
ec2. archive. ubuntu, 



precise-updates/main i386 Packages 
com precise-updates/universe i386 Pa 



ec2.archive.ubuntu.com precise-updates/main Translation! 
ec2.archive.ubuntu.com precise-updates/universe Translat 



ec2.archive.ubuntu.com precise/main Translation-en [726 



.archive.ubuntu.con 
ec2. archive. ubuntu, 



precise/universe Translation-en 
com precise-updates/nain Translation- 



042 kB in 2s 
ckage lists,. 



2, archive, ubuntu, com precise-updates/universe Translatior 

(1,702 kB/s) 
, Done 



iWiTJUSramimaanj 



Screen shot after update process is completed 



PI dont forget to press enter after each line of command. 



After Apache installation is completed successfully it needs to be tested. This can be done by 
keying in the IP number associated with the VPS to the address bar of the browser. You should see 
the page saying "It Works". If this page is displayed then it indicates that apache server has been 
installed and is running fine. 
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B Most Visited' (el Getting Started Q Latest Headlines' 
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5j Google Translate -*§ Google URL Shortener 
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It works! 



This is the default web page for this server. 

The web server software is running but no content has been added, yet. 



Screenshot of the page indicating successful installation of apache server 



If on keying the IP number associated with the VPS to the address bar of browser the default page 
"It works" is not displayed / page not found error is displayed then key in the following command 
to the command terminal of SSH PUTTY client. 



sudo service apache! restart 

This command prompt effectively restarts the apache server. 



Installing MySQL 



My SQL 8 is a powerful database software. This is used to manage database, organizes and retrieves 
data from the database. This popular Relational Database System runs as a server providing 
multiuser access to a number of databases. My SQL actually does not have a GUI and needs to be 
manipulated using command line tools. For installing Eprints not much knowlege of of structured 
query language is needed as the software is capable of configuring SQL server automatically. 



To Install MySQL open the terminal window using ssh client PUTTY after logging in as root you 
can type the following command: 



sudo apt-get install mysql-server Ubapache2-mod-auth-mysql php5-mysql 



* Documentation: https://help.ubuntu.com/ 



System information 



e Jun 11 15:52:17 UTC 2013 



System load; 0.0 Processes: 

Usage of /: i2M of 7.87GB Users loggei 

Memory usage; 41£ IP address for 

Swap usage: OK 

Graph this data and manage this system at https:/ 



Get cloud support with Ubuntu Advantage Cloud Gl 
http://wwijj.ubuntu.com/business/services/cloud 



se Juju to deploy your cloud instances ; 
https://juju.ubuntu.eom/#cloud-precise 



.ast loginMueJur^ 11:49:05 2013 from 
buritullip-^M ^^Ml "$ sudo su 

oot@ip-^^(^dftfcj/home/ubuntu# sudo apt-get install mysql-server libapache2- 
mysqll 



Screen shot showing the command keyed in to install mysql server 



.ast login^ueJur^L^ll;49;05 2013 f rom ^ 

ibuntuSip-^i BR"t sudo su 

■oot(hp-^J^^W^k:/home/ubuntu# sudo apt-get install mysql-server libapache2- 
>5-mysql 

leading pacKage lists,,. Done 

(uilding dependency tree 

heading state information**. Done 

"he following extra packages will be installed: 
libdbd-mysql-perl libdbi-perl libhtml -temp late-perl libmysqlclientlS 
libnet-daemon-perl libplrpc-perl libterm-readkey-perl mysql-client-5,5 
mysql-client-core-5,5 mysql-common mysql-server-5,5 mysql-server-core-5,5 
php5-common php5-fpm 

Suggested packages; 
libipc-sharedcache-perl tinyca mailx php5-suhosin php-pear 

"he following NEW packages will be installed: 
libapache2-mod-auth-mysql libdbd-mysql-perl libdbi-perl 
libhtml -temp late-perl libmysqlclientlS libnet-daemon-perl libplrpc-perl 
libterm-readkey-perl mysql-client-5,5 mysql-client-core-5,5 mysql-common 
mysql-server mysql-server-5,5 mysql-server-core-5,5 php5-common php5-fpm 
php5-mysql 

) upgraded, 17 newly installed, to remove and 40 not upgraded* 

Jeed to get 30,9 ME of archives, 

iftpr- this noeration, 107 MB of additional disk space will be used. 



Screen shot showing confirmation query after keying in the command to install mysql server 




aaaaaaaaaaaaaaaaaaaaaaH Configuring mysql-server-5,5 aaaaaaaaaaaaaaaaaaaaaaa 

a while not mandatory, it is highly recommended that you set a password a 

a for the MySQL administrative "root" user, a 

a a 

a If this field is left blank, the password will not be changed, a 
a a 

a New password for the MySQL "root" user; a 



a 
a 
a 
a 



<0k> 



=taaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa 




After installation mysql configuration screen asks for root password setting. You need to choose a 

password key it in. Press tab the ok button will be highlighted. On pressing the enter key the next 

confirmation password screen will be displayed asking for password retype. 



During installation MySQL will ask you to set a root password. Give a root password of your 
choice. If you have missed this step, it can also be easily done through MySQL shell. By default 
MySQL does not have a root password. 



MySQL now needs to be activated. You need to key in the following command in the command 
prompt window to activate it: 



sudo mysql jnstall _db 



The next step one need to take is to secure the MySQL database server installation. 
This can be done by keying in the following script in the command prompt window. 



sudo /usr /bin/my sql_secure_installation 



treating config file /etc/php5/fpm/php,ini with new version 

letting up libapache2-mod-auth-mysql (4,3,9-13ubuntu3) , ,, 

letting up libhtml-template-perl (2,10-1) ,„ 

letting up mysql-server (5,5,31-0ubuntu0,12,04,2) ... 

letting up php5-mysql (5,3,10-lubuntu3,6) , ,, 

Processing triggers for libc-bin , ,, 

Ldconfig deferred pr ocessing now taking place 

~oot@ip-^BB«Mii^Bl.:/home/ubuntu# sudo /usr/bin/mysql_secure_ install at ion 



CTE; RUNNING ALL PARTS OF THIS SCRIPT IS RECOMMENDED FOR ALL MySQL 
SERVERS IN PRODUCTION USE! PLEASE READ EACH STEP CAREFULLY! 



In order to log into MySQL to secure it, we'll need the current 
password for the root user. If you've just installed MySQL, and 
jou haven't set the root password yet, the password will be blank 
so you should just press enter here. 



inter current passwo 



root (enter 



none): | 



Screen shot showing the prompt asking for a change of root password 



The command prompt will now ask for the root password you had keyed in the previous window, 
you had not keyed in any password then all you need to do is to press the enter key, of if you had 
choosen a root password then key it in and press the enter key. 



If 



http;//www, ubuntu, com/business/services/cloud 

Use Juju to deploy your cloud instances and workloads; 
https ; // j u j u , ubuntu , com/#c 1 oud-prec i se 



packages can be updated, 
updates are security updates. 



rhe programs included with the Ubuntu system are free software; 
the exact distribution terms for each program are described in the 
individual files in /usr/share/doc/*/copyright. 



Jbuntu comes with ADSOLUTELY NO WARRANTY, 
applicable law. 



ro run a command as administrator (user "roof 
^ee "man sudo_root" for details. 



jse "sudo <command) 



ibuntu@ip-, 

inter new UNIX password; 

ietype new UNIX password; 

>asswd; p^ssiiinrrl UDrlflt.prl <= 

ibuntuQi 



Password change confirmation screen 



The next prompt will ask whether you need to set / change the root password. If you want to 
change it you need to key in the new password and press the enter key. You need to do it twice for 
confirmation. 

It should be borne in mind the default MySQL server installation has an anoymous user enabled. 
So one can log into MySQL database as a anoymous user. This access has been provided in order 
to conduct tests to find out whether MySQL server has been installed. In production environment 
anoymous user to the database need to be disabled. The previous step is intended to secure this 
installation. 

When the command prompt asks: 

Remove anonymous users? [Y/n] - You need to give yes by keying in "Y" and pressing the enter 
key. 



In order to log into MySQL to secure it, we'll need the current 
password for the root user. If you've just installed MySQL, and 
you haven't set the root password yet, the password will be blank, 
so you should just press enter here. 

Enter current password for root (enter for none): 
OK, successfully used password, moving on,,. 

Setting the root password ensures that nobody can log into the MySQL 
root user without the proper authorisation, 

You already have a root password set, so you can safely answer 'n'. 

Change the root password? [Y/n] n 
,,, skipping. 



By default, a MySQL installation has an anonymous user, allowing anyone 
to log into MySQL without having to have a user account created for 
then. This is intended only for testing, and to make the installation 
go a bit smoother. You should remove them before moving into a 
production environment. 

Remove anonymous users? [Y/n] 



Screen shot showing command prompt asking whether anonymous users can be removed. 

answer should obviously be yes. 



The 



For security purposes normally root should be able to connect to the database only from the "Local 
Host". This can be ensured by giving the following command for the next prompt which is likely to 
come into your command prompt window: 

Disallow root login remotely? [Y/nJ: You need to press "Y" and press enter key following it. 



etting the root password ensures that nobody can log into the MySQL 
*oot user without the proper authorisation. 



'ou already have a root password set, so you can safely answer 'n'. 

Change the root password? [Y/n] n 
... skipping. 



Sy default, a MySQL installation has an anonymous user, allowing anyone 
;o log into MySQL without having to have a user account created for 
;hem. This is intended only for testing, and to make the installation 
o a bit smoother. You should remove them before moving into a 
production environment. 

iemove anonymous users? [Y/n] yes 



.ormally, root should only be allowed to connect from 'localhost'. This 
insures that someone cannot guess at the root password from the network, 

lisallow root login remotely? [Y/n] I 



By default MySQL database server comes with a Test database already installed. This is meant for 
testing purposes only. It should be removed when moving to a production environment. 



In the next command prompt: 



Remove test database and access to it? [Y/n]: 
This removes test database. 



You need to press "Y" and press enter key later. 



isallow root login remotely? [Y/n] yes 
. . . Success I 



j default, MySQL comes with a database named 'test' that anyone can 
;cess. This is also intended only for testing, and shoul 
sfore moving into a production environment. 

;move test database and access to it? [Y/n] yes 

- Dropping test database... 
... Success! 

- Removing privileges on test database... 
... Success! 

^loading the privilege tables will ensure that all changes mat' 
ill take effect immediately. 

;load privilege tables now? [Y/n] 



The next prompt asks: 

Reload privilege tables now? [Y/nJ: You need to key in "Y" and press enter key later. 

After cleaning up the MySQL installation has completed. 



It is time now to start your MySQL server. Key in the command given below in the command 
prompt window: 



sudo service mysql start 



This will start MySQL server. 




start: , 
'ootSipi 



/home/ubuntu# sudo service mysql start 
y running: mysql 
t/home/ubuntutt I 



Installation of PHP 



PHP also known as (Hypertext preprocessor) is an open source web scripting language used to 
create dynamic web pages. It is a server side scripting language installed in a server. This scripting 
language was originally created by Rasmus Lerdof in 1995 9 . This scripting language is operating 
system independent and can be installed as part of any server or as a stand alone application too. 

In order to install PHP to ubuntu server log into the virtual machine using SSH client (PUTTY) as 
root. In the ensing terminal key in the command given below: 



sudo apt-get install php 5 Ubapache2-mod-php5 php5-mcrypt 



You may need to answer "yes" twice in the command prompt. PHP will install itself. 



rootE ip- 
php5-mcrypt 



|/home/ubuntu# sudo apt-get install php5 libapache2-mod-php 
ists,,» Done 



Reading state information* ♦♦ Done 

The following extra packages will be installed; 

apache2-mpm-prefork libmcrypt4 php5-cli 
Suggested packages; 

php-pear libmcrypt-dev mcrypt 
The following packages will be REMOVED; 

apache2-mpnrworker 
The following NEW packages will be installed; 

apache2-mpm-prefork libapache2-mod-php5 libmcrypt4 php5 php5-cli phpE 
upgraded, 6 newly installed, 1 to remove and 40 not upgraded. 
Need to get 6,296 kB of archives* 

After this operation, 17,3 MD of additional disk space will be used. 
Do you want to continue [Y/n]? I 



Screen shot asking for confirmation to install php 



Unpacking libmcrypt4 (from , ♦♦/libmcrypt4_2,5.,S-3. 1 l_amd64,deb) ♦ ,, 

Selecting previously unselected package php5. 

Unpacking php5 (from ,.,,/php5_5,3,10-lubuntu3. 1 6_all,deb) , „ 

Selecting previously unselected package php5-cli. 

Unpacking php5-cli (from ,.,,/php5-cli_5,3 t 10-lubuntu3,S_amdS4,deb) ,.,, 

Selecting previously unselected package phpEJ-mcrypt, 

Unpacking php5-mcrypt (from ♦ ♦,/php5-mcrypt_5.,3,5-0ubuntul_amd64,deb) 

Processing triggers for man-db , ,♦ 

Setting up libapache2-mod-php5 (5,3,10-lubuntu3,6) ... 

Creating config file /etc/php5/apache2/php,.ini with new version 

* Restarting web server apache2 

,,♦ waiting 
Setting up libmcrypt4 (2*5, 8-3,1) ,,, 
Setting up php5 (5,3.,10-lubuntu3,6) ... 
Setting up php5-cli (5,3.,10-lubuntu3,6) , „ 



Creating config file /etc/php5/cli/php,ini with new version 
update-alternatives; using /usr/bin/php5 to provide /usr/bin/php (php) in auto 
ode* 

Setting up phpEJ-mcrypt (5,.3,5-Oubuntul) , „ 
Processing triggers for libc-bin ... 
ldconfiq deferred processing now taking place 
':/home/ubuntutt I 



Command prompt window as seen after completion of php installation 



Now you need to restart apache to complete the settings change. This can be done by keying the 
command given below. 



sudo service apache! restart 



You may want to add useful PHP modules and libraries to your virtual machine. This can be done 
using the same command prompt window. For a beginner I would advice these module / libraries 
installation be deferred till Webmin is installed. It would provide a nice GUI for manipulating these 
modules and libraries. The curious can attempt command prompt installation method given below. 



To see the possible libraries / modules available key in the command given below in the command 
prompt window: 



apt-cache search php5- 



-intl - inter nationalisation not 

-lasso - Library for Liberty Alliance and SAML protocols - PHP 5 bindings 

-librdf - PHP5 language bindings for the Red land RDF library 

-napscri 

-ncrypt - MCrypt nodule for php5 

-nencache - nemcache extension nodule for PHP5 



-nidgard2 - Midgard2 Content Repository - PHP5 language bindings and nodule 

-ning - Ming nodule for php5 

-nysqlnd - MySQL noi" 

-ps - ps nodule for PHP 5 

-radius - PECL radius module for PHP 5 

-renctl - PECL nodule for Kerf 

-rrd - rrd nodule for PHP 5 

-sasl - Cyrus SASL extension for PHP 5 

-suhosin - advanced protection no<' n 

-sun - PHP Bindings for tb ' 

-Sybase - Sybase / MS SQL Server nodule for php5 

-tokyo-tyrant - PHP interface to Tokyo Cabinet's network interface, Tokyo Tt 



interface, Tokyo Tt 



-uuid - OSSP uuid module for php5 
-xcache - Fast, stable PHP opcode cacher 
-xdebug - Xdebug Module for PHP 5 



The terminal will display the possible libraries that can be installed. The list could be like this: 



php5-cgi - server-side, HTML-embedded scripting language (CGI binary) 

php5-cli - command-line interpreter for the php5 scripting language 

php5-common - Common files for packages built from the php5 source 

php5-curl - CURL module for php5 

php5-dbg - Debug symbols for PHP5 

php5-dev - Files for PHP5 module development 

php5-gd - GD module for php5 

php5-gmp - GMP module for php5 

php5-ldap - LDAP module for php5 

php5-mysql - MySQL module for php5 

php5-odbc - ODBC module for php5 

php5-pgsql - PostgreSQL module for php5 

php5-pspell - pspell module for php5 

php5-recode - recode module for php5 

php5-snmp - SNMP module for php5 

php5-sqlite - SQLite module for php5 

php5-tidy - tidy module for php5 

php5-xmlrpc - XML-RPC module for php5 

php5-xsl - XSL module for php5 

php5-adodb - Extension optimising the ADOdb database abstraction library 

php5-auth-pam - A PHP5 extension for PAM authentication 



After deciding on the modules to be installed the they can be installed individually by keying in the 
following command in the command prompt window: 



sudo apt-get install name of the module 



These modules can also be installed after installing webmin via its GUI interface. This method is 
easy for a beginner. 



PHPMyAdmin " Installation 



This script written in PHP provides a good GUI interface for managing SQL tables and data. Entire 
database of Mysql can be managed using this web interface. This takes away the pain of keying in 
commands in the command prompt window. 



sudo apt-get install phpmyadmin 



http ; //www * ubuntu * com/bus i ness/ser v i ces/c 1 oud 

Use Juju to deploy your cloud instances and work 
https://juju*ubuntu*com/#c loud-precise 



ist login: Tue 
)untu@ip' 



WHO 



%*'$ sudo su 
_ c/home/ubuntu# sudo apt-get install phpmyadmin 
lists** * Done 
jilding dependency tree 
ading state information,*. Done 
le following extra packages will be installed: 

dbconf ig-common fontconf ig-conf ig libfontconf igl libgd2-xpm libjpeg-turboS 
libjpegS libtl-5 libxpm4 php5-gd ttf-dejavu-core 
iggested packages: 
libgd-tools 

is following NEW packages will be installed: 

dbconf ig-common f ontconf ig-conf ig libfontconf igl libgd2-xpm libjpeg-turboS 
libjpegS libtl-5 libxpm4 php5-gd phpmyadmin ttf-dejavu-core 
upgraded, 11 newly installed, to remove and 40 not upgraded* 

~! of archives* 
■ter this operation, 22*6 ME of additional disk space will be used* 
) you want to continue [Y/n]? I 



Screen shot showing command prompt seeking permission before installation of PHPMyadmin 



During installation the PHPMyadmin installer will walk you through the various configuration 
parameters. 

As a first step you need to select the server. In this case select Apache which will be the first one in 
the list. Selection can be made by pressing the space bar. Press the tab key till the OK button gets 
red and then press enter key for the settings to take effect. 



Package configuration 



1 Configuring phpmyadmin | 

Please choose the web server that should be automatically configured to 
run phpMyAdmin. 

Web server to reconfigure automatically: 



] apache2 
I liqhttpd 



=Ok; 



The next question the installer will pose is whether you want to configure the 
database for PHPMyadmin with db-config common. The answer should be yes. 



1 Configuring phpmyadmin | 

The phpmyadmin package must have a database installed and configured 
before it can be used. This can be optionally handled with 
dbconfig-common. 

If you are an advanced database administrator and know that you want to 
perform this configuration manually, or if your database has already 
been installed and configured, you should refuse this option. Details 
on what needs to be done should most likely be provided in 
/ us v j share/doc/ phpmyadmin. 

Otherwise, you should probably choose this option. 

Configure database for phpmyadmin with dbconfig-common? 

<No> 



In the next screen the installer will ask if you want to reset / change the mysql root password. If 
you had not set the root password during installation of mysql server now is the time to do it. 

Otherwise you can safely skip this step. 




After installation is complete phpmyadmin should be added to apache configuration file. This can 
be done using command line editor or the step can be deferred till you complete installation of 
webmin when you will have a comfortable GUI and text editor to do the job. 



sudo nano /etc/apache2/apache2.conf 



This command prompt will evoke nano editor in the command prompt window and you need to add 
the line given below to the apache2.conf File displayed on your screen. 



Include /etc/phpmy admin/apache, conf 



Now you need to restart apache server. 



sudo service apache2 restart 



PHPMyadmin installation can be checked by keying in the following in the address bar of your 
favorite web browser: 



youripaddress/phpmyadmin 



phpMij/\Oi tin 

Welcome to phpMyAdmin 



Language 



English 



Log In n. 



Username; 
Password: 




_^ Cookies must be enabled past this point. 



This will be the screen displayed 



You can enter the interface by giving: 
user name: root 



Password: your root password 



phpMyAdm'm 

St M 4 # a « 

, lnfonnation_schema 

j mysql 

i performar>ce_scliema 

! pnpmyadmin 



JJ : SQL ^ Status ^ Processes ill Privileges ^ Export &} Import <> Variables ^ Charsets ▼ More 



General Settings 



Change password 



MySQL connection collation <* : utfS_general_ci 



Appearance Settings 



4 J Language e : I English 



Theme / Style: pmanomme ▼ 



• Font size: 92% * 
J^ More settings 



MySQL 



Server Localhost via UNIX socket 

Server version: 5.5.31-Ojubunjtu0.12_04.2 

Protocol version: 10 

User root@localno5t 

MySQL charset: UTF-8 Unicode (utf8) 



Web server 



Apacne/2.2.22 (Ubuntu) 
MySQL client version: 5.5.31 
PHP extension: mysqli i> 



php My Admin 



Version information: 3.4.10.1deb1 

Documentation 

Wiki 

Official Homepage 

Contribute 

Get support 

List of changes 



Webmin Installation 



Webmin 10 is actually a web based open source control panel which can be used to configure and 
control the virtual private server. Configuration can be done using any of the modern browser 
interface. Java should be enabled in these browsers for using file manager module of webmin. It 
can be used to set up and configure user accounts, Apache configuration, DNS settings, file sharing 
etc. It can also be used to edit various linux configuration files. 



Before actually attempting to install webmin the various Perl files need to be installed. This can be 
done by keying in the following command as root in the command prompt window of SSH client 
PUTTY. 



sudo apt-get install perl libnet-ssleay-perl openssl libauthen-pam-perl 
libpam-runtime libio-pty-perl apt-show-versions python 



After keying in the above command continuously and pressing the enter key the perl dependencies 
of webmin gets installed. 



root@}ip-1 0-203-78-11: /home/ubu 



https:// 



. com/#c 1 oud-pr ec i se 



00:06:17 2013 from 117.193.153.73 

jbuntu@ip4MOT^^HF:™$ sudo su 

-oot@ip-10-203-78-ll;/home/ubuntu# sudo apt-get install perl libnet-ssleay-perl 

jpenssl libauthen-pam-perl libpam-runtime libio-pty-perl apt-show-versions pytht 

i 

heading package lists... Done 

building dependency tree 

heading state information... Done 

'. ibpam-runtime is already the newest version, 

>ython is already the newest version. 

>erl is already the newest version. 

"he following extra packages will be installed; 

libapt-pkg-perl 
"he following NEW packages will be installed: 

apt-show-versions libapt-pkg-perl libauthen-| 

libnet-ssleay-perl 
"he following packages will be upgraded; 

openssl 



L upgraded, 5 newly installed, to 
■j^^rl tn r.^f fi 7 n) gf archives. 

J .,323 kD of ac 



39 not upgraded. 



Screen shot showing command prompt seeking permission to install perl 



Webmin .deb package needs to be downloaded. This can be done easily by keying in the command 
given below: 



wget http://prdownloads.sourceforge.net/webadmin/webmin_l .630 _all.deb 



,630_all,deb [following] 

-2013-06-12 00:45:45— http://downloa 

i/l ,630/webn i n_l ,630_al Ldeb 

iesolving downloads.sourceforge.net (downloads.sourcefor9e.net),,, 216,34,181,5!" 

ieusing existing connection to prdownloads,sourceforge,net:80, 

ITTP request sent, awaiting response,,, 302 Found 

.ocation; http;//i web, dl,sourceforge, net/pro ject/webadmin/webnin/l,630/webmin_l 

!30_all,deb [following] 

—2013-06-12 00:45:46 — htt p :// i web , d 1 , sour cef or ge , net/pro j ect/webadm i n/webm i n/ 

. , 630/webm i n_l , 630_a 1 1 , deb 

iesolving iweb,dl,sourceforge,net (iweb, dl.sourceforge.net),,, 70,33,0,134, 260/ 

f 748:10:12: :5f:2 

:onnecting to iweb,dl,sourceforge,net ( iweb,dl,sourceforge, net) 170,38,0,1341 ;80 
♦ connected, 

ITTP request sent, awaiting response,,, 200 OK 
Length: 21101770 (20M) [application/x-debian-package] 
iaving to: *webmin_l,630_all,deb' 

.002[======================================>] 21,101,770 2,10M/s in 12s 

'013-06-12 00:45:57 (1,70 MB/s) - *webmin_l,630_all,deb' saved [21101770/211017: 



''hone/ubuntutt 



Screenshot of command prompt displayed on completion of webmin download 



The downloaded package can be installed using the following command: 



sudo dpkg i- webmin_l.630_all.deb 



OTHm^^ftt/home/ubuntu# sudo dpkg -i webmin_l.630_all.deb 
Selecting previously unselected package webmin. 

Reading database . .. 50054 files and directories currently installec 
Inpacking webmin (from webmin_l.630_all.deb) . .. 
: etting up webmin (1*630) . .. 



Unpacking webmin (from webmin_l.530_all.deb) . .. 
Setting up webmin (1.630) , ,, 

Webmin install complete. You can now login to https;//ip-' 
as root with your root password, or as any user who can us 
to run commands as root. 



Screen shot showing webmin installation confirmation screen 



Webmin can be accessed by keying in the following address in your favorite browser's address bar: 

https://vourIP: 10000 

If you have a domain pointing to the virtual private server then it can be substituted for the IP 
address. 



You need to ignore the browser warning which says that the certificate for the site cannot be trusted. 



Login to Webmin 


You must enter a usemame and password to login to the Webmin server on 


User name 












Password 








_ 1 Remember login permanently? 






Login 


Clear 





In the log in screen as shown above you need to key in root as the user name and the root password 
of your linux virtual private server. 



Login: root 

Webmin 

System 

Servers 

Others 

Networking 
, Hardware 

Cluster 
i> LTn-used Modules 
Search: | 

ziiView Module's Logs 
flfr System Information 
f5 Refresh Modules 

& Logout 



^ uiebmin 

System hostname 

Operating system Ubuntu Linux 12.04.2 
Webmin version 1.630 
Time on system Wed Jurc 12 01:03:56 2013 
Kernel and CPU Linux 3.2.0-40-virtual onx86_64 
Processor Information Intel(R) Xeon(R) CPU E5430 @ 2.66GHz r 1 cores 
System uptime 1 days. hours. 26 minutes 
Running processes 75 

CPU load averages 0.00 (1 min) 0.09 (5 mircs) 0.10 (15 mire) 
CPU usage 2% user, 5% kernel, 7% IO, S6% idle 
Real memory 590.19 MB total. 179.04 MB used 



Local disk space 7.87 GB total. 1.73 GB used 



Module 


Version 


Running Processes 


1.632 


Running Processes 


1.631631 



Package updates 39 package updates are available 

The 2 following Webmin module updates are now available .. 
Fixes problem 

Fixes total and free memory display on OpenVZ systems 
Fixes incorrect memory display on OpenVZ 



Install Updates Now 



This is the webmin screen. You can install updates by clicking the install updates button now. 



Eprint Installation 



Main advantage of installing eprints in ubuntu is there are preconfigured installation files available, 
hence one need not encounter dependency issues during installation. 

To install preconfigured eprint installation repositories need to be added to the ubuntu repo list. The 
list is present in /etc/apt/sources. list. The following lines need to be added to this list using the file 
browser feature of webmin. 

Log into webmin using root password. 

On the side bar click the others button. 



Login: root 




Webmin 


System 


Servers 


'- Others 


Command Shell 


■"■■"-' raHim a n rl c 


r \ ^ 




Perl Modules 




PHP Configuration 


Protected Web Directories 


SSH Login 


System and Server Status 


Text Login 


Upload and Download 


Networking 


Hardware 


Cluster 


i> Un-used Modules 


Search: | 




Zi View Module's Logs 


fit System Information 


f§ Refresh Modules 


(§) Logout 



# 



<£$> 



^ 



m 

Del et e 



au? 

Hew 



• # 



Upload 



V 



B 



P 



i 4 



Q 



copy 




Cut Paste 



-Qbin 

-(djboot 

-Qjdev 

H^etc 

-Qhonie 

-ft lib 

-ftlib64 

-^lost+found 

-ftmedia 

— (^jrant 

-ftopt 

-Jjiproc 

-ft root 

-Qrun 

-^sbin 

-^selinux 

-^srv 

-fttmp 
-Qusr 
Hjj|var 



r 



J/. 



Name 



ea 




id 


bin 


r;. 


boot 


Q 


dev 


Lj 


etc 


id> 


home 




init rd . img 


idi 


lib 


n 


Ub64 


Lj 


lost+found 


Lj 


media 


Lj 


mnt 


Lj 


opt 


r. 


proc 


Lj 


root 


a 


run 


Id 


sbin 


L.1 


selinux 


Lj 


srv 


ti 


sys 


Id 


tnp 


Idl 


usr 


Lj 


var 




vmlinuz 


u 


webmin-setup.out 



Size 



User 



Grou 



L_L 



4 kB 


root 


4 kB 


root 


3 kB 


root 


4 kB 


root 


4 kB 


root 


33 B 


root 


4 kB 


root 


4 kB 


root 


16 kB 


root 


4 kB 


root 


4 kB 


root 


4 kB 


root 


G B 


root 


4 kB 


root 


4G B 


root 


4 kB 


root 


4 kB 


root 


4 kB 


root 


G B 


root 


4 kB 


root 


4 kB 


root 


4 kB 


root 


29 B 


root 


8 kB 


root 



root 
root 
root 
root 
root 
root 
root 
root 
root 
root 
root 
root 
root 
root 
root 
root 
root 
root 
root 
root 
root 
root 
root 
root 



Date 



11/Apr 

11/Jun 

11/Jun 

G6:44 

11/Apr 

11/Apr 

11/Apr 

11/Apr 

11/Apr 

11/Apr 

Apr/12 

11/Apr 

11/Jun 

G6:34 

G6:51 

11/Apr 

Mar/12 

11/Apr 

11/Jun 

15:47 

11/Apr 

06:25 

11/Apr 

06:26 



On clicking the file manager this view will open up provided Java is enabled in your browser. 



## Uncomment the to L Lowing two Lines to add software from CanomcaL's 
## 'partner' repository, 

## This software is not part of Ubuntu, but is offered by Canonical and the 
## respective vendors as a service to Ubuntu users. 

# deb http://archive.canonical.com/Libuntu precise partner 

# deb-src http://archive.canonical.coin/ubuntu precise partner 

deb http://security.LibLintLi.com/ubuntu precise-security main 
deb-src http://security.ubuntu.com/ubuntu precise-security main 
deb http://security.LibLintLi.com/LibLintu precise-security universe 
deb-src http://security.ubuntu.com/ubuntu precise-security universe| 

# deb http://security.Libuntu.com/LibLintu precise-security multiverse 

# deb-src http : //security , ubuntu ,com/ubuntu precise-security multiverse 



deb http://deb.eprints.org/ stable/ 
deb-src http://deb.epnnts.org/ source/ 



deb http : //deb . eprints . org/ stable/ 
deb-src http : //deb . eprints . or g/ source 



Log into the virtual machine using SSH client like PUTTY. 

Become root user. 

Key in: 

sudo apt-get update 

This command will update repository list by including eprint data. 



Sudo apt-get install eprints 



iet;lG http;//us-east-l,ec2, archive, ubuntu, com precise-updates/universe andG4 Pi 
;kages [206 kB] 

'it http://us-east-l,ec2, archive, ubuntu, com precise-updates/main i386 Packages 
jet;17 http;//us-east-l,ec2, archive, ubuntu, com precise-updates/universe i386 Pat 
;ages [209 kB] 

'ettlS http;//deb, eprints, org stable/ Packages [865 B] 

jet;19 http;//us-east-l,ec2, archive, ubuntu, com precise-updates/main Translation! 
idex [3,564 B] 

*et;20 http;//us-east-l,ec2, archive, ubuntu, com precise-updates/universe Translal 
onlndex [2,850 B] 

.it http://us-east-l,ec2, archive, ubuntu, con precise/main Translation-en 
-et;21 http;//us-east-l,ec2, archive, ubuntu, com precise/universe Translation-en I 
,341 kB] 

,et;22 http;//deb, eprints, org source/ Sources [2,737 B] 
!gn http: //deb, eprints, org stable/ Trans 1 at ion-en_US 

!et;23 http;//us-east-l,ec2, archive, ubuntu, com precise-updates/main Translation- 
*n [280 kB] 

.it http://us-east-l,ec2, archive, ubuntu, com precise-updates/universe Translatioi 
■en 

!gn http: //deb, eprints, org stable/ Translation-en 
: etched 15,8 MB in 10s (1,515 kB/s) 
ieading package lists,,. Bone 

/home/ubuntutt sudo apt-get install eprintsl 



Command prompt showing installation of eprints 



Iibltdl7 liblua50 1 iblualibSO liblwp-mediatypes-perl 
liblwp-protocol-https-perl libmagickcore4 libmagickcore4-extra 
libmagickwand4 libmail-sendmail-perl libmail tools-perl li' 
libmime-types-perl libmodule-f ind-perl libnet-http-perl libnetpbmlO 
libopenexrG libpangol*0-0 libpaper-utils libpaperl libpathplan4 libperl5*14 
libpixman-1-0 libpopplerl9 libreadlineS librsvg2-2 librubyl.8 
libsearch-xapian-perl libsepoll libsmG libsocketG-perl 

libsys-hostname-long-perl libthai-data libthaiO libtie-ixhash-perl 1 ibtif f4 
libtre5 li bun i code-string-perl libunistringO liburi-perl libwmf 0*2-7 
libwww-perl libwww-robotrules-perl libxaw7 libxcb-renderO libxcb-shmO 
libxfontl libxft2 libxml-libxml-perl libxml-libxslt-perl 
libxml-namespacesupport-perl libxml -parser-perl libxml -sax-base-perl 
libxml-sax-expat-perl 1 ibxml -sax-perl libxml-twig-perl libxml-xpath-perl 
libxml2-dev libxmuG libxpG libxrenderl libxsltl*l libxtG lmodern luatex lynx 
lynx-cur netpbm nullmailer pdftk po-debconf poppler-data poppler-utils 
psutils tex-common texlive-base tex live-binaries texlive-common 
texlive-doc-base texlive-luatex unzip xll-common xfonts-encodings 
xfonts-utils xpdf 

) upgraded, 160 newly installed, to remove and 39 not upgraded* 

Jeed to get 115 MB of archives* 

Ifter this operation, 301 ME of additional disk space will be used* 

)o you want to continue [Y/n]? I 



Command prompt screen asking for confirmation to continue with eprint installation 



liblwp-protocol-https-perl libmagickcore4 libmagickcore4-extra 
libmagickwand4 libmail-sendmail-perl libmail tools-perl libmi me- lite-perl 
libmime-types-perl libmodule-f ind-perl libnet-http-perl libnetpbmlO 
libopenexrG libpangol*0-0 libpaper-utils libpaperl libpathplan4 libper 15*14 
libpixman-1-0 libpopplerl9 libreadline5 librsvg2-2 librubyl*8 
libsearch-xapian-perl libsepoll libsmG libsocketG-perl 

libsys-hostname-long-perl libthai-data libthaiO libtie-ixhash-perl 1 ibtif f4 
libtreS libunicode-string-perl libunistringO liburi-perl libwmf 0*2-7 
libwww-perl libwww-robotrules-perl libxaw7 libxcb-renderO libxcb-shmO 
libxfontl libxft2 libxml-libxml-perl libxml-libxslt-perl 
libxml-namespacesupport-perl libxml-parser-perl libxml -sax-base-perl 
libxml -sax-expat-perl libxml -sax-perl libxml -twig-perl libxml-xpath-perl 
libxml2-dev libxmuG libxpG libxrenderl libxsltl*l libxtG lmodern luatex lym 
lynx-cur netpbm nullmailer pdftk po-debconf poppler-data poppler-utils 
psutils tex-common texlive-base texlive-binaries texlive-common 
texlive-doc-base texlive-luatex unzip xll-common xfonts-encodings 
xfonts-utils xpdf 

) upgraded, 160 newly installed, to remove and 39 not upgraded* 

Jeed to get 115 MB of archives* 

}fter this operation, 301 MB of additional disk space will be used* 

Jo you want to continue [Y/n]? yes 

JARNING; The following packages cannot be authenticated! 
eprints 

Install these packages without verification [y/N]? | 



Command prompt seeking confirmation to continue installing unverified packages. Yes should be 
keyed in and enter key pressed once to proceed further 



It 

it Getting Started: 


## 
## 


It Before you can start using eprints you need to 


## 


It configure your install, follow these simple steps; 


## 


it 


## 


It # su eprints 


## 


It You have to logged in as the eprints user to operate 


## 


it with eprints 


## 


It # cd 


## 


It To the eprints home directory (/usr/share/eprints3) 
It 


## 


It # „/bin/epadmin create 


## 


It Follow the instruction to create your archive* 


## 


It # exit 

* 


WW 

## 


n 

It # a2ensite eprintsS 
ft 


m 
## 


It # apache2ctl restart 


## 


It 


## 


It ##### DONE ###M 




n 

It For more documentation please see the eprints wiki; 


WW 
m 


It http ; //w i k i , eprints, or g/w/Documentat i on 


## 



Eprint installation completed. 



After installation of eprint is completed now the installation should be configured. Eprint 
installation folder is present in /usr/share/eprints3. This should be remembered because it is 
important during configuration procedures. 



Setting up a new repository: 

This is the first step that should be taken during eprint configuration. For this to proceed a 
password need to be set up for eprint user. 



passwd eprints 



In the command prompt window key in the above command. 



System information as of 

System load: 0,01 

Usage of /; 22. « of ' 

Memory usage: 50£ 

Swap usage; 02 



■■n™«W»:»CTIHI»»il 



Graph this data and manage this system at https;//landscape, canonical ,com/ 

Get cloud support with Ul 
http ; //www , ubuntu , com/bus i ness/serv i ces/c 1 oud 

Use Juju to deploy your cloud instances and workloads: 
https://juju.ubuntu.eom/#cloud-precise 

42 packages can be updated, 

L9 updates are security updates, 

.ast login : Med Jun 1 2 11:32:05 2013 from 117,193,15 

ibuntu@i p_ 

'ootQip-4^^H^^9:/home/ubuntu# passwd eprints 

nter newTNTXpassword: I 



In this screen shot you can see that you have the opportunity to create a password for eprint server. 
You need to key in the pass word and press enter twice. 



System information as of Wed 



15:18:15 UTC 2013 



System load; 0,01 Processes: 7E 

Usage of /: 22, At of 7,S7GB Users logged in: 

Memory usage: 50£ IP address for ethO; 

Swap usage; 01 

Graph this data and manage this system at https;//land; 

Get cloud support with Ubuntu Advantage Cloud Guest; 
http;//www,ubuntu, com/business/services/clout 

Use Juju to deploy your cloud instances and workloads; 
https ; // j u j u , ubuntu , com/#c 1 ou 

42 packages can be updated, 

.9 updates are security updates. 



Last login: wed .km~12. 11:32:0! 

ubuntu@i 

root@ ip^WWWWW^S/home/ubuntu* passwd eprints 

Enter new UNIX password; 

RptuDp npiii IINTii D^ssword; I 



Screenshot showing the command prompt window asking for creation of password for eprint server 



usage or / 



Processes; 
I of 7.87GB Users loggei' 

IP address for ethO;* 



is system at httpst/Zlanr 1 - 



Memory usage; 5C 
Swap usage; 03 



'"-luntu Advantage Cloud Guest; 
ss/serv i ces/c 1 oud 

se Juju to deploy your cloud instances and workloads; 
https ; //j uj u , ubuntu , com/#c 1 oud-pr ec i se 



■2 packages can be updated, 

.9 updates are security updates. 



.ast login* 
ibuntu@ip ' 
'ootQip - 
inter m-„ 



maam 



i;"$ sudo su 
__ /home/ubuntu# passwd eprints 
lord; 




dated successfully 
t/home/ubuntu 
L;/hone/ubuntu$ | 



Screen shot showing password for eprint server changed successfully 

Now is the time to log into eprint server as root user with all privileges. 

This you can do by keying in the following command in the command terminal. 



sudo su eprints 



You need to get into the folder in which eprints has been installed. 
The command for this step is as follows: 



cd /usr/ share/ eprints3 



usage or / 



Memory usage; 5C 
Swap usage; 03 



Processes; 
I of 7.87GB Users logged 

IP address for eth0;l 



--; this system at https^/lanr 1 - 



ith Ubuntu Advantage Cloud Guest; 
, com/bus i ness/serv i ces/c 1 oud 



se Juju to deploy your cloud instances and workloads; 
https;//ju,ju,ubuntu,com/#c loud-precise 



12 packages can be updated, 

.9 updates are security updates. 



ast logir 
pbuntu@ip- 
-ootQip' 
inter m-„ 



fe™$ sudo su 
:/home/ubuntu# passwd eprints 
lord; 




dated successfully 
t/home/ubuntu 
L;/home/ubuntu$ | 



Screen shot showing sudo su eprints command being executed 



Usage of /; ! 

Memory usage; 50K IP adi 

Swap usage; 01 

Graph this c' 

Get cloud support with Ubuntu Advantage CIol 
http ; //www , ubuntu , com/I 



Use Juju to deploy your cloud instances and workloads; 
https;// juju, ubuntu, com/#c loud-precise 

\2 packages can be updated* 

.9 updates are security updates. 



j/home/ubuntu* passwd eprints 



.ast login* l,lorl Tlln "" "M *39*<tc 9ni3 frn» i 
ibuntu@ip-' 
■■ootQip-i ~ 
"nter new UN1K |- 
tetype new UNIX password; 
jasswd; Dasswon^JPdated successfully 
-oot@ip4^^H""**^»!/home/ubuntu# sudo su eprints 
pr i nts@ i f^^pj— MB^» /home/'ubuntu$ cd /usr/shan 
prints@ip^Bes«i»^^ft~$ ,/bin/epadmin createl 



Screen shot showing ./bin/epadmin create being used 



i Juju to deploy your cloud instances and workloads; 
https;// juju, ubuntu, com/#cloud-precise 

'2 packages can be updated, 

,9 updates are security updates, 

.ast logi n; wed Jun 12 11; 32; 05 2013 fromC" 
ibuntu@ip-^H ■JP^"'$ sudo su 
■BBM^PT/horiie/ubuntu 
hter new UNIX password; 
letype new UNIX password; 
■asswd; Msswor^uDdated successfully 
oot@ip-:WM*****^/home/ubuntu# sudo su eprints 
ipr i nts@ i p -^^— ^^"^ ; /home/ubuntu$ cd /usr/share/eprints3 
!prints@ip-^B wsww, Wi;"$ , /bin/epadmin create 

>eate an EPrint Repository 

'lease select an ID for the repository, which will be used to create a directory 
ind identify the repository. Lower case letters and numbers, may not start with 
i number, examples; "lemurprints" or "test3" 

Irchive ID? otolaryngology! 



Screen shot showing command window asking for archive ID 



You will be prompted to provide archive ID. This ID will actually be used to create a directory in 
the eprint server and will also serve as an identification of the repository. Lower case letters and 
numbers can be used. The name should not start with a number. For testing purposes you can use 
the name "testl" for the archive. After choosing a name for archive ID a folder by that name will 
be created and relevant config files will be copied to it. 

The command prompt will ask for confirmation to configure vital settings. The answer should be 
yes followed by a press of enter key. 



Installing: 
Installing: 
Installing; 
Installing: 
Installing: 
Installing; 
Installing: 
Installing: 
Installing; 
Installing: 
Installing: 
Installing: 
Installing: 
Installing: 



v usr/share/e 
v usr/share/e 
v usr/share/eprint: 
v usr/share/epr i nt: 
v usr/share/e 
v usr/share/eprint: 
v usr/share/epr i nt; 
v usr/share/e 
v usr/share/eprint: 
v usr/share/epr i nt: 
v usr/share/epr i nt: 
v usr/share/epr i nt: 
v usr/share/epr i nt: 
v usr/share/epr i nt: 



wmaBsmsmm mm 



3/archives/otolaryngology/cfg/static/style/auto 
3/ar ch i ves/oto 1 ar y ngo 1 ogy /cf g/autocomp 1 ete 



3/ar ch i ves/oto 1 aryngo 1 ogy/cfg/ 1 ang 
3/ar ch i ves/oto 1 ar y ngo 1 ogy /cf g/ 1 ang/en 



3/ar ch i ves/oto 1 aryngo 1 ogy/cfg/ 1 ang/en/stat i c/he 1 p 
3/archi ves/oto laryngology/cfg/lang/en/phrases 
3/archi ves/oto laryngology/cfg/workf lows 
3/ar ch i ves/oto 1 aryngo 1 ogy/cfg/workf 1 ows/epr i nt 
3/arch i ves/oto 1 aryngo 1 ogy/cf g/workf 1 ows/user 
3/archi ves/oto laryngology/cfg/themes 



Ok, I've created the initial config files and directory structure, 
I've also created a "diskO" directory under documents/ if you want 
your full texts to be stored on a different partition then remove 
the diskO, and create a symbolic link to the directory you wish to 
store the full texts in, Additional links nay be placed here to be 
used when the first is full. 



Configure vital settings? [yes] ? | 



Scree shot showing the installer seeking premission to configure vital settings 



After giving yes and hitting the enter key further queries regarding other configuration settings will 
be posed by the eprint server to you. 



Host name: You need to give a host name in this window. It is actually the name when keyed in to 
your browser address bar will take you to the repository archive. You should already have a domain 
registered with a domain registrar and your domain should be pointing to the IP address of your 
virtual private server. 



Install ing: /usr/share/eprintsi/archives/otolaryngology/cfg/workf lows/eprint 
Installing: /usr/share/eprints3/archives/otolaryngology/cfg/workf lows/user 
llnstalling: /usr/share/eprintsS/archives/otolaryngology/cfg/themes 

lOk, I've created the initial config files and directory structure, 
I've also created a "diskO" directory under documents/ if you want 
your full texts to be stored on a different partition then remove 
the diskO, and create a symbolic link to the directory you wish to 
store the full texts in, Additional links may be placed here to be 
used when the first is full. 



Configure vital settings? [yes] ? yes 
Core configuration for otolaryngology 



IPlease enter the fully qualified hostname o 



-epos i tor y. 



For a production system we recommend against using the real hostname of the 
machine. 

Example; Otolaryngol ogy,footle,ac,uk 

Hostname? otolaryngology, co,in| 



For production system it is better not to use the real host name. You can always use "your archive 
name.localdomain." 

Now comes the query regarding web server port. 

Which port do you want to serve your archive on? The default port happens to be 80 and would be 
already entered there. If you want to stay with the default port just give enter and proceed to the 
next screen. 

Now comes the scree for alias: 

Here you can enter any number of aliases which will take users to the archive. You can serve your 
repository in various aliaes like eprints.mine.org, eprints.archive.org. After you have completed 
giving aliases you need to enter # and press enter key once. These aliases should be taken into 
consideration while configuring domain name that points towards the archive. This setting redirects 
requests from various aliases to the archive you have specified. 



When the configuration screen asks for confirmation to redirect all your choosen aliases to the host 
name give yes and press enter key once. 



In the next screen you will be asked to enter the path part of the repository's Base URL. This 
should be very simple. If you cant think of something just accept the default given [/] by pressing 
enter key once. 

In the next screen you will be given an opportunity to configure https host name. If you want to use 
secure server for log in pages you need to give the name in this screen. Otherwise you can skip this 
step by pressing the enter button once. 



Next comes the screen asking you to specify email of administrator. This will enable repository 
users to contact you. Please give the admin email account name in this screen. 

The installer will now ask for the archive name. This is the full name of the repository you are 
creating. It will also be displayed in the title bar of the browser displaying the archive. Just key in 
the desired name and press enter key once. 

The next question seen in the command prompt window would be a confirmation and permission to 
write those specified settings. If the answer is no then you say no and press enter key once, then 
one need to start repository configuration right from the start again. If yes it takes you to the next 
screen. 

Next settings screen one need to focus is on the database configuration settings for the archive in 
question. In order for you to start this configuration you need to say yes to launch configdb 
archive jd. On launching configdb archiveid you will be presented with a screen where you can 
name the database. It is always better choose the default name which happens to be the name of the 
archive. It would have already been choosen by you by eprints server. All you need is to press the 
enter key once to accept default settings. Similarly you can choose the default settings for host, port 
and socket settings of the mysql database. All you need to do is to keep pressing the enter key for 
each of these settings to accept the default values. 

In the next screen user of database will be choosen. If you are not particular to have a unique name 
you are welcome to choose the default user name and eprints will keep track of it. The same goes 
for the choice of database user password. You can choose the default password alloted by eprints 
server by pressing the enter key once. You need not remember these details also. Eprints will keep 
track of them all for you. The configure screen will ask you for confirmation whether these settings 
could be written to the database. 

You can press enter button to accept all the database settings. In order to write to the database 
eprints need to know your root user name and password for the mysql server. This was already set 
by you while you installed mysql server in your virtual machine. Now is the time to enter the user 
name (which is root in this case) and root password when the prompt asks. You need to press enter 
key after keying in the root user name and press enter again after keying in the root password. 

After the database has been successfully created the eprint server will offer to create user for 
administering the repository. Now is the time to choose user name and press enter. While choosing 
the password you cannot start with a number or special character. Dont bother you can always 
change the password after installation. In the next prompt you will be asked the role which the 
created user is supposed to play (admin, user etc). In this case one need to choose admin as the 
role. Then you will be asked for email id of the user which you need to key in now and press enter 



key immediatly there after. 



You need to give yes when permission is sought by eprint server to create LOC subjects, create 
static pages etc. 

The next query will be whether you want to update apache config files. It would also remind you to 
verify whether the include line for eprint server has been added to apache config file. This can be 
verified by making sure that eprints3 file is in /etc/apache2/sitesavailable/ folder and eprints3 file 
contain the following line: Include /usr/share/eprints3/cfg/apache.conf 



■ieindexing item; 
■^indexing item; 
^indexing item; 
^indexing item; 
^indexing item; 
^indexing item; 
■^indexing item; 
■^indexing item; 
■^indexing item; 
^indexing item; 
^indexing item; 
■^indexing item; 
^indexing item; 
^indexing item; 
^indexing item; 
■^indexing item; 
■^indexing item; 
■^indexing item; 
Done re indexing 
Ending EPrints R 



subject, 
subject, 
subject, 
subject, 
subject, 
subject, 
subject, 
subject, 
subject, 
subject, 
subject, 
subject, 
subject, 
subject, 
subject, 
subject, 
subject, 
subject, 



'fac_med 
'sch_art 
'sch_bio 
v sch_che 
'sch_civ 
'sch_ecs 
'sch_edu 
'sch_eng 



v sch_law 
v sch_man 
'sch_mat 
v sch_med 
v sch_phy 



'sch_soc 
'subjects 



epos i tony. 



ixiting normally, 

!lo you want to update the a 

'Include' line) [yes] ? yes 



Screen shot showing configuration screen seeking permission to update apache config files 



Now make any required changes to the cfg files. 



Note that changing the metadata configuration may re< 

tables to be regenerated, epadmin erase_data will regenerate the 

eprints and documents tables only, erase_data will regenerate everything, 

(nb, these also do erase the contents of the ta 

files). 

Make sure that your main a| 

Include /usr/share/eprints3/cfg/apache,conf 

Then stop and start your webserver; 
Often; 

/etc/rc,d/init,d/httpd stop 

/etc/rc,d/init,d/httpd start 
(or maybe /usr/local/apache/bin/apachectl stop & start) 

And then try connecting to your repository. 



Screen shot of the configuration screen after completion of configuration settings 
These are the steps performed during configuration of the eprint server 12 

Create an EPrint Repository 

Please select an ID for the repository, which will be used to create a directory 

and identify the repository. Lower case letters and numbers, may not start with 

a number, examples: "entprints" or "test3" 

Archive ID? uclapr 

We need to create /var/lib/eprints3/archives/uclapr, doing it now... 

Getting uid and gid information for apache 

UID: 48 

GID: 48 

Configure vital settings? [yes] ? yes 

Hostname? eprints.adastral.ucl.ac.uk 

Webserver Port [80] ? 80 

Please enter all the aliases which could reach the repository, and indicate if 

you would like EPrints to write a Redirect Rule to redirect requests to this alias to the correct URL. 

Some suggestions: 

eprints.adastral 

eprints 

Enter a single hash (#) when you're done. 

Alias (enter # when done) [#] ? eprints.adastral 

Redirect entw-server to entw-server.grs.de [yes] ? 

Alias (enter # when done) [#] ? # 

Please enter the path part of the repository's base URL. This should probably be '/". 

Path[/]? 

If you will use https for your user pages (including login) enter the https hostname 

here, or leave blank when using http only. 

Hostname? 

Administrator Email? *******@adastral.ucl. ac.uk 

Archive Name [Test Repository] ? UCL Adastral Park Repository 

Write these core settings? [yes] ? yes 

Configuring Database for: uclapr 

Database Name [uclapr] ? ********* 

MySQL Host [localhost] ? localhost 

MySQL Port (# for no setting) [#] ? 

MySQL Socket (# for no setting) [#] ? 

Database User [******] ? 

Database Password? 

Write these database settings? [yes] ? yes 

Create database "uclapr" [yes] ? 

Database Superuser Username [root] ? 

Database Superuser Password? 

Create database tables? [yes] ? 

Create an initial user? [yes] ? 

Enter a username [admin] ? 

Select a user type (user| editor | admin) [admin] ? 

Email? *******@adastral.ucl. ac.uk 

Do you want to build the static web pages? [yes] ? 

Do you want to import the LOC subjects? [yes] ? no (I have a custom subject file) 

Do you want to update the apache config files? (you still need to add the 'Include' line) [yes] ? yes 



You need to restart apache server now. 

There are two ways to restart the apache server now. 

Restarting apache server using command prompt window: 

For this to happen you need to get out of the eprint server which you have been configuring for so 
long. Just type exit in the command prompt and press enter key once. This will take you out of the 
eprint server and push you into the virtual machine. Now you key in the command given below to 
restart apache server. 



sudo service apache2 restart 



This will restart the server. 

The next method is to restart apache server via webmin. For this you need to log into webmin 
interface using your browser. You need to key in the user name and password to access the 
interface. 



In the webmin interface side bar click the servers button. It will open up showing a server list. 
Choose apache from the list to take you to the apache config screen. 



.ogin: root 

Webmin 
Svstem 




Networking 
► Hardware 

Cluster 
^ Un-used Modules 
3earch: 



A View Module's Logs 
fit System Information 
(§! Refresh Modules 
© Logout 



Screenshot of webmin interface showing the list of servers 



Module Config 



Apache Webserver 

Apache version 2.2.22 




Apply Changes 
Stop Apache 
Search Docs.. 



Global configuration Existing virtual hosts 


Create virtual host 




Select all. | Invert selection. 








^—\ Defines the default settings for all other 


virtual servers, and processes any unhandled 


requests. 


'^"^S Address Any 




Server Name Automatic 




*—^ Port Any 




Document Root Automatic 




Default Server 








s— \ Handles the name-based server e 


► "•£ Address 




Server Name r 

Document Root /usr/share/eprintsS 




Virtual ServerPort 30 




Select all. | Invert selection. 








Delete Selected Servers 





In the apache webserver screen you will see stop apache button which can be clicked and toggled 

with start apache 



If you key in your IP in the browser address window you should be able to see eprints log in screen. 



? 



ENTPR1NTS 




Welcome to Entrepo 

This is an Otolaryngology repository where otolaryngologists can store their manuscripts. 
Authors can deposit their manuscripts after registering themselves In this site. 



3 Atom BJRSS1.0 EflRSS2.0 



Latest Additions 

View items added to the repository in the past week. 



Search Repository 

Search the repository using a full range of fields. Use the search field at the top of the page for a quick search. 



Browse Repository 

Browse the items in the repository by subject. 



u 



---:.:■: Uiis Repository 

More information about this site. 



Repository Policies 

Policy for use of material in this repository. 



Entrepo SUpp:>r I v CA: L .' ..itha base URL of http://rhinnlngY.in/cgi/nai2 



Entrepo is powered hy EPrinrs 3 wtiich isdevebped by in; :■":-:.. :- r -:■:•■:■• :■: ■'■' :; '.:-::. :y :'■■ :-:.s at the Unh/ersityof Souih^mplcn '.: " ■- , : - .v - •■.■ :■ ■:::': ;y?. :■-■': :■.. . 



: -gofogy online 



Screenshot showing eprints log in screen 



Regular maintenace of eprint installation is a must. The following tasks need to be performed 
frequently because EPrints front end web pages and abstracts *are not* automatically updated when 
you make changes to the repository. To apply your changes and update the web pages: 

1 . Generate views 

2. Generate statistics 

3. Generate abstracts. 

These maintenance tasks can easily be performed using command prompt window. 
Using SSH client PUTTY you should log into your virtual machine as root. 

1 . sudo su eprints 

2. In the next prompt enter eprint server user password 

3. You will be logged into eprints server 

Key in the following command to generate views: 
bin/generate _views yourarchivename 
Key in the following command to generate statistics: 
bin/generate _static yourarchivename 

Key in the following command to generate abstracts: 

bin/generate _abstracts yourarchivename 

Remember you need to press enter button after giving each command for it to be executed. 



The above said tasks can also be performed using eprint admin interface. 

First you need to log into eprint site as admin using the admin user name and password. This can 
be done via browser interface. Now on clicking the admin button you will be taken to admin 
interface where you can perform these tasks by clicking the appropriate buttons. 



Admin 



b 



Stop Indexer 



Regenerate Abstracts 



u 



Editorial Tools System Tools 

Status information for this server. 
Create a new user account 

Forcefully stops and cleans up the indexer, then restarts it. 
Stops the full-text indexer. 

Cause abstract pages to be regenerated when they are next requested 
Cause views pages to be regenerated when they are next requested. 
Manage, Update and Install add-ons from the EPrints Bazaar. 
Test your email configuration by sending a test email. 
Show the database schema. 



Config. Tools 



Eprint admin interface where one can perform maintenance tasks 
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Explanation of terms used in this book: 

1 . Repository - Indicates a location for safe storage and preservation 

2. OAI - Open archives initiative - Document standard that facilitates efficient dissemination of 
digital content 

3. LAMP - This is actually a software bundle comprising Linux (operating system), Apache (Web 
server) MySQL (Database software) PHP, PERL, and Python (the languages used in developing this 
software) 

4. GUI - Graphic user interface. 

5. SHH - Secure shell is a cryptographic network protocol used for secure data communication via 
command line. 



6. Apache - this is an opensource server software. Rough estimates reveal that nearly 50% of 
world's servers run apache. This is a http server. 

7. SQL - Means structured query language 



8. Database - This application stores a collection of data. The common application used for this 
purpose is MySQL server. 



